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EXHffirrc 

Jnrtial Release 4.5 
Function : Calendaring and Scheduling 
SchSrvRetrieve - Retrieve a schedule. 



ffinclude <schedule.h> 

STATUS LNPUBLIC SchSrvRetrieve( 
LIST FAR *pClientNames, 
UNID FAR "pApptUnid, 
TIMEDATE FAR *pApptOrigDate, 
DWORD dwOptions, 
TIMEDATE_PAIR FAR *plntefvai, 
LIST FAR *pNames, 
HCNTNRFAR-rethCntnr); 

Description : 

When this call is made on a sen/er, it synchronously retrieves 
locai or remote schedules from the proper fanout servers. When this call is 
made on a client, it retrieves only locally available information in 
busytime.nsf 

This container must be deallocated by the caller usrng SchContalner^Free. 
Parameters ; 
Input : 

pClientNames * List of users making query. 

pApptUnId - Ignore this UNID in computations. 

pApptOrigDatG - This Is the original start date of the appointment to 
ignore. This is only here for Organizer 2.x compatibility. 

dwOptions - Option flags: 

SCHRQST.COMPOSITE default if dwOptions is 0 
SCHRQST_EACHPERSON return each person's schedule 

SCHRQST_LOCAL only look up schedules locally 

pinterval - Pointer to a TlMEDATE_PAJR structure that specifies the range 
over which the free time search should be performed. In typical scheduling 
applications this might be a range of 1 day or 5 days. 

pNames - Pointer to a list of distinguished names whose schedule should 
be searched. This list is in TEXT_LlST format without the datatype word. 
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This iist can be build with the textlist pacl<age (e.g. ListAlIocate) 
Output : 

(routine) - NOERROR - Successfully retrieved a schedule. 
ERR_xxx - There are many possible errors. It is best to use the code in a 
call to OSLoadString and display/log the error for the user as your default 
error handling. 



rethCntnr - Handle of the container that results are returned in. 



See Also : 

SchContainer_Free 
SCHRQST^ 
SchRetrieve 
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